home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / tsr / snippr25.zip / SNIPPER.DOC < prev    next >
Text File  |  1992-08-12  |  4KB  |  96 lines
  1. SNIPPER         Version 2.5  920812  (See revisions below)
  2. Command
  3.  
  4. Tom Kihlken          1987/No. 19 (Utilities)
  5.  
  6.  
  7. Purpose:    Copies any portion of a text screen to a printer or file, or
  8.  inserts it as keyboard input into an applications program.
  9.  
  10. Format:    [d:][path]SNIPPER [rows,columns]
  11.  
  12. Remarks:    SNIPPER is a memory resident program that is normally loaded
  13.  as part of your AUTOEXEC.BAT file.  The rows,columns parameter is required
  14.  for EGA displays with more than the normal 25 rows and 80 columns.  The 
  15. default "hot key" is Alt-W; Esc returns you to your application.
  16.  
  17.     When SNIPPER is popped up, it creates its own cursor, which is moved
  18.  by the normal arrow keys.  To create the window of interest, press Enter to
  19.  anchor the upper-left corner.  The cursor keys then open and size the window,
  20.  which appears in reverse video.  It is not necessary to press Enter again to
  21.  anchor the lower right corner.  Doing so, indeed, will pop up a help menu
  22.  showing the options described below.
  23.  
  24.     When the desired area is shown, pressing P dumps its contents to your
  25.  printer, adding carriage return/line feed characters at the end of each line. 
  26.  SNIPPER then automatically terminates.  Pressing F with the window open
  27.  prompts for a filename, which may include drive and path.  If no filename is
  28.  entered, SCREEN.CUT is used as a default.  Pressing Enter writes the marked
  29.  screen contents to the file.  SNIPPER then terminates, but remembers the
  30.  filename.  Successive saves to the same filename are appended to and do not
  31.  overwrite that file.
  32.  
  33.     Pressing S while a portion of the screen is marked saves the window
  34.  contents to an internal buffer.  Another applications program can then be
  35.  called up, and its cursor positioned at the point where the saved window 
  36.  contents should be inserted.  Alt-W then activates SNIPPER, and G gets its
  37.  stored contents and dumps them into the keyboard buffer as if they had been
  38.  typed in by hand.  Note that G must be the first SNIPPER command used in this
  39.  case (any other erases its internal, stored buffer).  Note, too, that G can
  40.  be used without S to reenter marked material (e.g. a complex DOS command 
  41.  sequence) on the same screen page.
  42.  
  43. Note:
  44.  The default hot key can be changed using DEBUG by substituting the Scan code
  45.  and Shift mask values listed in the article.  The address of the Scan code
  46.  byte is :0176, and that of the Shift mask is :0186.   Note that these patch
  47.  areas are DIFFERENT than the ones published in the original magazine
  48.  article.  The address of the prefix characters for quoted text (options "Q"
  49.  and "M" - see v2.5 below) is :0196.
  50.  
  51.  File SNIPPER.DBG is included to serve as a guide for DEBUG input.  See
  52.  this file for additional comments and instructions.
  53.  
  54. Revisions:
  55.  Now supports expanded 101/102 key keyboards.  Passes correct scan code
  56.  for <Enter> key.  Moved patch locations, and made miscellaneous fixes.
  57.  (Tim Farley, 01/25/90)
  58.  
  59. v2.2a    19 May 90 Toad Hall Tweak (undistributed)
  60.  - Minor tweaks, reformatting, case changing.  No functional changes.
  61.  
  62. V2.3    Cursor Control Keys (Home,End,PgUp,PgDn) added by T.Gentile:
  63.  - HOME: Move cursor to left edge of screen/SNIPPER window
  64.  - END:  Move cursor to right edge of screen/SNIPPER window
  65.  - PgUp: Move cursor to top edge of screen
  66.  - PgDn: Move cursor to bottom edge of screen/SNIPPER window    
  67.  
  68. v2.4    14 Mar 91 Toad Hall Tweak
  69.  - Got a request for trailing space trimming.
  70.  - Request to consolidate new v2.3 functions (but keep v2.2+ fixes
  71.    missing in v2.3.
  72.  - Request to eliminate direct screen writes (conflict with
  73.    speech synthesizers, DeskView).
  74.  
  75.    Yes, We Can Do That.
  76.  
  77.    Home, End, PgUp, PgDn keys now work when marking text, to quickly
  78.    move to Left Margin (Home), Right Margin (End, replacing R key),
  79.    Screen Top (PgUp), and Screen Bottom (PgDn).
  80.  
  81.    Re the direct screen writes:  that's an easy fix: there AREN'T any
  82.    direct screen writes!  Only BIOS calls are used.
  83.  
  84. v2.5    12 August 92  Communications Quote Tweak
  85.  - enhance filename get routine to allow any valid DOS filename key
  86.    to be entered.
  87.  - add function "Q": save text to buffer prefixed with two quote
  88.    characters.
  89.  - add function "M": save text to file prefixed with two quote
  90.    characters.
  91.  
  92.  
  93. David Kirschbaum                 Larry Bennett
  94. Toad Hall                        (not an assembler expert)
  95. kirsch@usasoc.soc.mil            usr2059a@tso.uc.edu
  96.